---# 🔧 Blacki Engine System

Manual Engine Control with Custom HUD & Realistic Behavior

---

## 📌 DESCRIPTION

Blacki Engine System adds a realistic manual engine control mechanic to GTA V.

By default, every vehicle engine starts in the OFF state.
You must manually turn it ON using a configurable key.

This system adds immersion, realism, and better driving control without breaking vanilla gameplay.

The script works completely standalone.
No external dependency required.

If **BlackiNotificationManager.dll** is installed, the script will automatically use premium custom UI notifications.
If not installed, it safely falls back to GTA’s default notification feed.

No crashes. No hard dependency. Fully modular.

---

## ✨ FEATURES

• Manual engine ON/OFF toggle
• Engine starts OFF by default
• Automatic engine OFF when exiting vehicle
• Vehicle becomes undriveable when engine is OFF
• Realistic vehicle slow-down effect
• Custom engine start sound
• Custom engine OFF sound
• Clean custom HUD engine icon
• Non-stretched 16:9 HUD design
• Fully configurable via .ini file
• Optional premium notification support

---
• Press the configured key → Engine turns ON
• Exit vehicle → Engine automatically turns OFF
• When engine is OFF:
## 🚘 HOW IT WORKS

• Enter vehicle → Engine is OFF


* Vehicle cannot be driven
* Handbrake applied



## 🖥 HUD ICON SYSTEM (IMPORTANT)

This mod uses a custom texture dictionary:

BlackiEnginehud.ytd

You MUST install it correctly or the engine HUD icon will not appear.

---

## 📦 REQUIREMENTS

• ScriptHookV
• ScriptHookVDotNet
• OpenIV (for HUD texture installation)

Optional:
• BlackiNotificationManager.dll (for custom notifications)

---

## 📥 INSTALLATION

### 🔹 STEP 1 — Script Installation

Copy:

BlackiEngineSystem.dll

into:

Grand Theft Auto V\scripts\

Copy:

BlackiEngineSystem.ini

into:

Grand Theft Auto V\scripts\BlackiSystem\

---

### 🔹 STEP 2 — HUD ICON INSTALLATION (IMPORTANT)

1. Open OpenIV
2. Enable Edit Mode
3. Navigate to:

Grand Theft Auto V\mods\update\update.rpf\x64\textures\script_txds.rpf\

4. Drag and drop:

BlackiEnginehud.ytd

Final path must be:

Grand Theft Auto V\mods\update\update.rpf\x64\textures\script_txds.rpf\BlackiEnginehud.ytd

If this file is not installed correctly, the engine HUD icon will not display.

---

## 📂 FINAL FOLDER STRUCTURE

scripts\
  BlackiEngineSystem.dll
  BlackiSystem\
    BlackiEngineSystem.ini

mods\update\update.rpf\x64\textures\script_txds.rpf\
  BlackiEnginehud.ytd

---

## ⚙ CONFIGURATION

Open:

scripts\BlackiSystem\BlackiEngineSystem.ini

You can customize:

• Engine toggle key
• Vehicle slow-down factor
• HUD icon position
• HUD icon size
• Sound enable/disable
• Engine start sound
• Engine OFF sound

Example:

EngineToggleKey = K
SlowDownFactor = 0.85
IconX = 0.90
IconY = 0.80
IconSize = 0.04
EnableSound = true

---

## 🛠 TROUBLESHOOTING

• Make sure OpenIV is in Edit Mode
• Ensure BlackiEnginehud.ytd is installed correctly
• Ensure .ini file is inside BlackiSystem folder
• Check ScriptHookVDotNet.log if script does not load
• Make sure ScriptHookVDotNet is updated

---

## 📜 VERSION

v1.0
Initial Release
Manual engine toggle system
Automatic engine OFF logic
Custom HUD support
Configurable sound system
Modular notification support

---
